• *environment_definition_tables Function
• *page Function
• a5_Active_Link_CreateReadOnly Function
• a5_active_link_refreshdefinition Function
• a5_activelink_convert Function
• a5_activelink_createdefaulttable Function
• a5_audit_trail_deleterecord Function
• a5_batchactivelinkcreate Function
• a5_batchactivelinkdefine Function
• a5_batchpassivelinkdefine Function
• a5_check_tbls_sets_exist Function
• a5_convert_activelink_to_named_connections Function
• a5_copy_table Function
• a5_copy_tablefiles Function
• a5_create_table_textmode Function
• a5_createactivelinktabledialog Function
• a5_createmapdefn Function
• a5_createpassivelinktabledialog Function
• a5_csweb_gettables Function
• a5_cvt_to_alias_physical Function
• a5_display_tableset_info Function
• A5_DUPLICATE_TABLE Function
• A5_EDIT_STRUCTURE Function
• a5_find_mismatchedfields Function
• A5_FixDBFFieldNames Function
• A5_ForceCloseTables Function
• a5_generate_xbasic_importtotablefromfile Function
• a5_genericTableCRUDAction Function
• A5_Get_Filter Function
• a5_get_passive_link_tables Function
• a5_get_table_ptr Function
• a5_has_serversidequery Function
• a5_import_into_table Function
• a5_insert_table_field Function
• a5_is_activelinktable Function
• a5_is_crosslevel Function
• a5_is_mappedtable Function
• a5_is_passivelinktable Function
• a5_list_tables Function
• a5_load_speed_glossary Function
• a5_nativetablename Function
• a5_new_table Function
• a5_new_table_set_genie Function
• A5_PACK_DICTIONARY Function
• A5_PACK_TABLE Function
• a5_passivelinktabledatasource Function
• a5_prompt_for_tablename Function
• a5_prompt_local_tablename Function
• a5_qb_sp_report_metadata_passivelink Function
• a5_qrb_createpassivelink_sp_report Function
• a5_refreshactivelinkdialog Function
• a5_refreshpassivelinkset Function
• a5_ServerSide_FilterOrder_Get Function
• a5_sizetabletofit Function
• a5_table_by_example Function
• a5_table_delete Function
• a5_table_editor_toolbar Function
• a5_table_menu_enable Function
• a5_table_openview Function
• a5_table_removefiles Function
• a5_table_rename_low Function
• a5_table_set_exists Function
• a5_table_set_zip_send Function
• a5_table_statistics Function
• a5_tablearraypopulate Function
• a5_tableedbyex_tbar Function
• a5_tableisindatabase Function
• a5_tables_enum Function
• A5_TableSizeToFit_Dialog Function
• A5_WildcardSelect Function
• A5_ZAP_TABLE Function
• a5cs_get_tables Function
• a5cs_prompt_surrogatekey Function
• a5cs_promptfortable Function
• a5cs_promptfortablemulti Function
• CHECK_INDEXES_FOR_TABLE Function
• CREATE_TABLE Function
• DBF Function
• EOF Function
• gettabledata Function
• RECCOUNT Function
• recdeleted Function
• RECNO Function
• SearchTables Function
• STRIP_TABLE_PATHS Function
• TABLE and DB Functions Contrasted
• TABLE Function
• Table Menu Functions
• TABLE_CHOOSER_ACTUAL Function
• TABLE_IS_EMPTY Function
• TABLE_REMOVE Function
• TABLE_RESTRUCTURE Function
• TABLEAVG Function
• TABLECOUNT Function
• TableFinder Function
• TABLEMAX Function
• TABLEMIN Function
• TABLESUM Function

TABLEAVG Function

Syntax

Arguments

tablename

The full drive, path, name, and extension of the table. If you omit the drive, path, and extension, Alpha Anywhere searches the directory of the current table.

filter

A character filter expression that evaluates to a logical value. Selects records to average.

field

An expression based on numeric or exponent numeric field(s) in the Lookup_Table.

Description

Returns the average value for a field in records of a specified table.

Discussion

Searches the specified Lookup_Table for one or more records that satisfy the specified Filter, and returns the average of the values contained in the Lookup_Expression. The Filter must return a logical value, either True (.T.) or False (.F.). For example, to choose all of the records in a table, use the logical constant ".T." as a filter. To choose only the records where the STATE field is equal to TN, use the filter "STATE = 'TN'". Note that the entire filter is always in quotations, and the character value, TN, is in single quotes. NOTE: If no records satisfy the filter, Alpha Anywhere returns a zero value.

Assume that a department purchasing table (PURCHASE) contains the following records:

PURCHASE TABLE

>

MANAGER

COST, BILL_DATE, and PAID_UP

ANDRY

18500.00 01/01/2003 T

BROWN

49.95 02/01/2003 T

BROWN

12.99 04/01/2003 F

FARLEY

7995.00 03/01/2003 F

FARLEY

142.16 04/10/2003 T

FARLEY

423.00 05/10/2003 F

Note : for detailed explanations of the filter expressions used in these examples, see TABLECOUNT().

All Records

The following expression returns the average of the values in the Cost field for all records in the Purchase table.

? TABLEAVG("PURCHASE.DBF", ".T.", "COST")
= 4520.516667

Filter Using a Specific Character String

The following expression returns the average of the values in the Cost field for all records in the Purchase table where "Brown" is the manager:

? TABLEAVG("PURCHASE.DBF", "MANAGER = 'BROWN'", "COST")
= 31.47

Filter Using a Character Variable

The following expression returns the average of the values in the Cost field for all records in the Purchase table where the manager matches the character string previously assigned to the variable vManager.

? TABLEAVG("PURCHASE.DBF","Manager = '" + vManager + "' ", "COST")
= 2853.386667 'if vManager is "FARLEY"

Filter Using a Specific Number

The following expression returns the average of the values in the Cost field for all records in the Purchase table where the Cost is greater than 1000.00.

? TABLEAVG("PURCHASE.DBF", "Cost > 1000.00", "COST")
= 13247.50

Filter Using Numeric Variable

The following expression returns the average of the values in the Cost field for all records in the Purchase table where the Cost is greater than whatever amount has been previously assigned to the numeric variable vCost.

? TABLEAVG("PURCHASE.DBF", "Cost > " + vCost, "COST")
= 13247.50 ' if vCost = 1000.00

Filter Using a Specific Date Value

The following expression returns the average of the values in the Cost field for all records in the Purchase table where the Bill_Date is equal to or later than January 1, 2003.

? TABLEAVG("PURCHASE.DBF", "BILL_DATE >= {01/01/2003}", "COST")
= 4520.516667

Filter Using Date Variables

The following expression returns the average of the values in the Cost field for all records in the Purchase table where the Bill_Date is equal to or later than the date previously assigned to vBeginDate AND equal to or later than the date previously assigned to vEndDate.

? TABLEAVG("PURCHASE.DBF","BETWEEN(BILL_DATE,{"+DTOC(vBeginDate)+"},{"+DTOC(vEndDate)+"})","COST")
= 77.575000 ' if vBeginDate is 04/01/2003 and vEndDate is 04/30/2003

Filter Using Logical Variables

The following expression returns the average of the values in the Cost field for all records in the Purchase table where Paid_Up is true:

? TABLEAVG("PURCHASE.DBF", "PAID_UP", "COST")
= 6230.703333

While this expression averages the values in the Cost field for all records in the Purchase table where Paid_Up is not true:

? TABLEAVG("PURCHASE.DBF", ".NOT. PAID_UP", "COST")
= 2810.330000

Thanks to

Tom Cone

See Also

• Table Object Functions and Methods
• Other Table Functions
• Record Functions
• TABLE and DB Functions Contrasted
• Writing Expressions